MCP 문서 관리

메뉴

홈
문서 목록
관리자 로그인

문서 정보

최종 수정일:
2025-05-12 15:06
태그:
#MCP #Google Drive #파일검색 #문서관리

링크된 문서

Google Drive MCP 서버

Google Drive MCP 서버

Google Drive MCP 서버는, Google Drive와 통합하여 파일 목록 조회, 읽기 및 검색 기능을 제공하는 MCP 서버입니다. 이 서버를 통해 AI 어시스턴트는 사용자의 Google Drive 파일에 접근하고 관리할 수 있습니다.

주요 기능

파일 검색 및 접근

  • Google Drive 내 파일 검색 기능
  • 파일 이름과 MIME 유형 정보 제공
  • 모든 파일 유형에 대한 접근 지원

자동 파일 변환

Google Workspace 파일을 자동으로 내보내기 기능 제공: - Docs → Markdown - Sheets → CSV - Presentations → 일반 텍스트 - Drawings → PNG - 기타 파일은 원래 형식으로 제공

보안 인증

  • OAuth를 통한 안전한 인증
  • 사용자 권한 기반 접근 제어
  • 읽기 전용 접근으로 데이터 안전성 보장

도구

search

Google Drive에서 파일을 검색합니다.

입력 매개변수: - query (string): 검색 쿼리

반환 정보: - 일치하는 파일의 파일 이름 및 MIME 유형

리소스

이 서버는 다음과 같은 Google Drive 파일에 대한 접근을 제공합니다:

파일(gdrive:///<file_id>)

  • 모든 파일 유형 지원
  • Google Workspace 파일은 자동으로 변환되어 제공됨

시작하기

1. Google Cloud 프로젝트 설정

  1. 새 Google Cloud 프로젝트 생성
  2. Google Drive API 활성화
  3. OAuth 동의 화면 구성
  4. 테스트용으로는 "내부"로 설정해도 됨
  5. OAuth 범위 추가
  6. https://www.googleapis.com/auth/drive.readonly
  7. "데스크톱 앱" 애플리케이션 유형의 OAuth 클라이언트 ID 생성
  8. 클라이언트의 OAuth 키 JSON 파일 다운로드
  9. 키 파일 이름을 gcp-oauth.keys.json으로 변경하고 저장소 루트에 배치

2. 서버 빌드

다음 명령어 중 하나를 사용하여 서버를 빌드합니다: 

npm run build
또는 
npm run watch

3. 인증 설정

인증 및 자격 증명 저장을 위해: 1. auth 인자를 사용하여 서버 실행: 

node ./dist auth
2. 시스템 브라우저에서 인증 흐름이 열림 3. 인증 프로세스 완료 4. 자격 증명이 저장소 루트에 저장됨(.gdrive-server-credentials.json)

구성 방법

Claude Desktop에서 사용하기

Docker 사용

먼저 OAuth 키 파일 경로를 포함한 다음 명령어로 서버 인증: 

docker run -i --rm --mount type=bind,source=/path/to/gcp-oauth.keys.json,target=/gcp-oauth.keys.json -v mcp-gdrive:/gdrive-server -e GDRIVE_OAUTH_PATH=/gcp-oauth.keys.json -e "GDRIVE_CREDENTIALS_PATH=/gdrive-server/credentials.json" -p 3000:3000 mcp/gdrive auth

인증이 완료되면 앱의 서버 구성에 다음을 추가: 

{
  "mcpServers": {
    "gdrive": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-v",
        "mcp-gdrive:/gdrive-server",
        "-e",
        "GDRIVE_CREDENTIALS_PATH=/gdrive-server/credentials.json",
        "mcp/gdrive"
      ]
    }
  }
}

NPX 사용

{
  "mcpServers": {
    "gdrive": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-gdrive"
      ],
      "env": {
        "GDRIVE_CREDENTIALS_PATH": "/path/to/.gdrive-server-credentials.json"
      }
    }
  }
}

VS Code에서 사용하기

VS Code의 사용자 설정(JSON) 파일에 다음을 추가:

NPX 사용

{
  "mcp": {
    "servers": {
      "gdrive": {
        "command": "npx",
        "args": [
          "-y",
          "@modelcontextprotocol/server-gdrive"
        ],
        "env": {
          "GDRIVE_CREDENTIALS_PATH": "/path/to/.gdrive-server-credentials.json"
        }
      }
    }
  }
}

Docker 사용

{
  "mcp": {
    "servers": {
      "gdrive": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "-v",
          "mcp-gdrive:/gdrive-server",
          "-e",
          "GDRIVE_CREDENTIALS_PATH=/gdrive-server/credentials.json",
          "mcp/gdrive"
        ]
      }
    }
  }
}

사용 사례

  • 문서 검색: 특정 키워드나 주제에 관한 문서 검색
  • 파일 관리: 여러 문서와 파일에 쉽게 접근하고 정보 가져오기
  • 협업 지원: 공유 문서 및 팀 자료에 접근하여 협업 작업 지원
  • 콘텐츠 분석: Google Drive에 저장된 여러 문서의 내용 분석 및 요약
  • 보고서 생성: 여러 스프레드시트 및 문서의 데이터를 사용하여 보고서 생성

주의사항

  • 이 서버는 Google Drive에 대한 읽기 전용 액세스 권한만 요청합니다.
  • OAuth 자격 증명은 안전하게 보관해야 합니다.
  • Google Workspace 파일의 자동 변환은 일부 형식이나 복잡한 서식을 손실할 수 있습니다.

라이센스

이 MCP 서버는 MIT 라이센스에 따라 라이센스가 부여됩니다. 이는 MIT 라이센스의 이용 약관에 따라 소프트웨어를 자유롭게 사용, 수정 및 배포할 수 있음을 의미합니다.

관련 링크